Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Managing Groups

Q3Group_SetPositionObject

You can use the Q3Group_SetPositionObject function to set the object located at a certain position in a group.

TQ3Status Q3Group_SetPositionObject (
TQ3GroupObject group, 
TQ3GroupPosition position, 
TQ3Object object);

group

A group.

position

A group position.

object

An object.

DESCRIPTION

The Q3Group_SetPositionObject function sets the object having the position specified by the position parameter in the group specified by the group parameter to the object specified by the object parameter. The object previously occupying that position is disposed of. The reference count of object is incremented.

Q3GroupPosition_SetObject returns, as its function result, either a pointer to the object installed in the specified position, or NULL if an error occurs.

ERRORS

kQ3ErrorInvalidObject
kQ3ErrorInvalidObjectForGroup
kQ3ErrorInvalidObjectForPosition
kQ3ErrorInvalidPositionForGroup